home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / btrieve / btfiler / sample.bts < prev   
Encoding:
Text File  |  1992-02-18  |  3.0 KB  |  85 lines
  1. #
  2. #   This line (and all lines beginning with '#') are COMMENTS.
  3. #
  4. #   This is a sample BTrieve Supplemental Index (BTS) file.
  5. #   It allows for the creation of a supplemental index (key)
  6. #   for Btrieve files in BTFILER.  It does the same thing
  7. #   as the BUTIL -SINDEX function, but with one significant
  8. #   difference:  Error diagnostics are clearer.  This removes (I
  9. #   think) the most significant problem with the BUTIL -SINDEX
  10. #   process.  Someday an interactive utility for this will be part
  11. #   of BTFILER, but until then, this will have to do...
  12. #
  13. #   Case is not important, and some fields are optional (as
  14. #   noted in comments).
  15. #
  16. #   This field is the only field possible on the file level section:
  17. #
  18. #      ALTERNATE FILE=<filename>           OPTIONAL if no alternate key
  19. #
  20. #
  21. #
  22. #  ALTERNATE FILE=fname, where fname is the name of a file like
  23. #     UPPER.ALT.  This line is optional IF no ALTERNATE=YES
  24. #     key segments exist.
  25. #
  26. ALTERNATE FILE=UPPER.ALT
  27. #
  28. #  END OF FILE LEVEL SETTINGS!
  29. #
  30. #  This marks the beginning of key segment level information.
  31. #     If I were you, and I were creating BTB files, I would
  32. #     place a large comment band between each key segment
  33. #     to remind myself what I think I am doing.  Just a
  34. #     thought...
  35. #
  36. #  The lines for each key segment are in the following order:
  37. #
  38. #     START=n, where 'n' is the starting position of the key
  39. #     LEN=n, where 'n' is the length of the key
  40. #     MODIFIABLE=s, where 's' is Y or N (or YES or NO or Yes or...)
  41. #                      Allows Modifications to be made to the key?
  42. #     DUPLICATES=s, ditto above...Allows Duplicate keys?
  43. #     ALTERNATE=s, where 's' is as above.  Alternate Collating Sequence?
  44. #     DESCENDING=s, like above.  Sorts Hi to Lo?
  45. #     MANUAL=s, like above, Manual key?
  46. #     TYPE=t, where 't' is EXACTLY one (case difference OK) of the following:
  47. #
  48. #                           "String",
  49. #                           "Integer",
  50. #                           "Float",
  51. #                           "Date",
  52. #                           "Time",
  53. #                           "Decimal",
  54. #                           "Money",
  55. #                           "Logical",
  56. #                           "Numeric",
  57. #                           "Bfloat",
  58. #                           "Lstring",
  59. #                           "Zstring",
  60. #                           "Unsigned Binary",
  61. #                           "Autoincrement",
  62. #
  63. #     NULL=n, where 'n' is the decimal NULL value (commonly 0 or 32) OR
  64. #                NULL=N/A to explicitly state no NULL value.
  65. #                NULL= is OPTIONAL.
  66. #     SEGMENT=s, where 's' is Y or N (or Yes or N0...).  The number of
  67. #                segments with a SEGMENT=No value MUST be one in this case
  68. #                since only a single supplemental index can be declared
  69. #                at once.
  70. #
  71. #  Segment 1
  72. #
  73. START=1
  74. LEN=22
  75. MODIFIABLE=n
  76. DUPLICATES=n
  77. ALTERNATE=n
  78. DESCENDING=n
  79. TYPE=STRING
  80. NULL=N/A
  81. SEGMENT=NO
  82. #
  83. #  That's all, folks!
  84. #
  85.